Directory Lister 'Read me' file
Version 0.6
(C) 2002 Copyright by Leszek Skorczynski
http://freeware.prv.pl
Program goal
Directory Lister lets you list files in selected directories
on hard disks, cd-roms, floppys etc. into a HTML or TXT file (listing). It's like the DIR command but
MUCH more convenient.
General rules
Directories for diskettes are not read upon start. You must click on diskette
icon to force reading directories.
You can always press 'F5' to clear and update
directory structure (eg. when you change CDs).
Preview window in Windows 9x is limited to ~32kB size so it does not display
whole listing if it's too big. However, the listing is properly saved
to the disk.
Selecting directories
(Checked white box) - list this directory and
all subdirectories recursively,
(Checked gray box) - list this directory but
not all of its subdirectories (not all could also be none),
(Gray box) - list some of the subdirectories of this
directory,
(White box) - do not list this directory and none of
its subdirectories.
Only 'top' directories checked with 'checked white box' are saved to a selection file (DLS).
Subdirectories are read during generation of a listing.
Command line usage
DirLister.exe [/l directories.dls output.[txt|html]] [/o configuration.dlc]
- where:
- directories.dls - previously saved list of directories to list
output.txt - listing itself
configuration.dlc - previously saved user configuration
/l - reads list of directories, generates listing, than closes
/o - reads configuration from a file
- Example:
-
C:\Program Files\Directory Lister\DirLister.exe /l c:\my documents\ftpdirs.dls c:\ftp\file_listing.html /o c:\my documents\myconf1.dlc
- this example reads configurations from 'c:\my documents\myconf1.dlc',
reads directories to list from 'c:\my documents\ftpdirs.dls', generates 'c:\ftp\file_listing.html', and finally closes (since '/l' option was specified).
Shortcut keys
F5 - refresh folders view
F12 - Switch between 'Select directories' / 'Preview'
Options page
Include box
- Dir names - this will display directory name above the files /
subdirectories listing. If you also check Name
checkbox, directory name will be sourrounded with
two lines consisting of '-' chars.
- Dir size - this will display directory size above the files /
subdirrectories listing. If you set mask different
than '*.*' the size will be counted only from files
which match the mask.
- File count in dir name - this will display file count (in brackets) for each
directory just after directory name. This option works
only if 'Dir names' option is checked.
- Subdirs - this will display subdirectories apart from files.
- File number - this will display consecutive file number in front of file name.
- File path - this will display files / subdirectories with
full path, not only the file / subdirectory name.
- Name - this will display file / subdirectory name.
- Extension - this will display file extension. Subdirectories are assumed to have no
extension (that is '.' is not perceived as extension determinant).
- Size - this will display the file size and '<dir>' string for
subdirectories.
- Date - this will display file / subdirectory last modified date.
- Time - this will display file / subdirectory last modified time.
- File version - this will display file version - if available. Usually version
information is saved in executable files (exe, dll, ocx, etc.).
- CRC32 - this will display the file CRC32 value (exactly the same as
in zip/rar archives).
WARNING! Although CRC32 procedure is faster than in
most other programs, counting CRC32 for big files can take a lot of time!
(But you can always press ' Cancel' button.)
- Attributes - this will display file / subdirectory attributes,
where 'r' is readonly, 'a' is archive,
'h' is hidden, 's' is system.
Options box
- Mask - only files / subdirectories which match the mask will be listed.
Subdirectories which don't match the mask will be processed but not displayed
when Subdirs checkbox is checked.
You can specify multiple masks separating them with ';' e.g:
'*.avi;*.txt'
Wildcards ('*?') are allowed as well as sets ('[a-z] [!d]').
- Example:
-
- Files not starting from a,b,c; having 4 characters in name and any
extension:
[!a-c]???.*
- Sort files and subdirs - causes files and subdirectories to be sorted as well
as directories tree. If you uncheck this, directories tree will not be unsorted.
- Sort dirs - causes directories to be sorted. Directories are always sorted by
name. Check this option if you want to sort directores by other
attributes.
- Descending - this will reverse the order of sorting for directories, files and
subdirectories.
- Sort files all together - this option will sort files as if they were in one
directory. This option works only if 'Dir names' and 'Dir size'
options are unchecked and 'Sort files and subdirs' option is checked.
- Number files all together - this option will number files as if they were in one
directory. This option works only if 'Dir names' and 'Dir size'
options are unchecked and 'File number' option is checked.
- Sort by - you can choose how to sort directories, files and subdirectories.
Items are sorted first by chosen attribute then by name.
- Size display - displays directory and file sizes in Bytes, Kilobytes, Megabytes,
Gigabytes or Dynamic - depending on size, in proper measure.
- Size precision - when you choose 'Size display' other than Bytes this is the
number of decimal digits after the point.
- Listing for each dir - this will generate listing in each listed
directory under the name taken from 'Name:' edit. Extension
is automatically added ('txt' or 'html').
WARNING! This file is ALWAYS overwritten so be sure not
to choose a name that will delete your own files!
- Remember dirs selection - this will save 'DirLister.dlc' containing current
selection on exit and load this selection file when you start
Directory Lister next time.
Path should be box
These options concern paths for files (if you check 'File path' checkbox) and directories
(if you check 'Dir names' checkbox).
- Full - will display whole path
- No drive - will not display the drive letter
- No parent dir - will display the path starting from the top-most white-checkbox
selected directory.
HTML options page
HTML options box
- Generate HTML - this will generate HTML page instead of plain text file.
- Generate links to dirs - this will generate links to actual directories.
Normally, directory path is copied into HREF part of a tag, except for Path should be: No parent dir
option. In this case HREF part does not contain leading '\' char, so you can copy HTML output file
to a 'Top dir' and you can browse its subfolders.